主题
模型调用 / API 密钥
「API 密钥」管理当前登录用户自己的调用凭证,用于在程序或工具中调用大模型服务。页面可以创建密钥、复制密钥、查看额度与剩余额度,并核对状态和到期时间。
前提条件
- 已登录 Console 用户侧,并具备「AI 模型服务」的访问权限。
- 已选择目标工作空间,示例为当前工作空间。
- 需要调用的模型已在「模型列表」中可见。
界面说明

截图采集于 2026-11-02,环境:主环境。
页面左上角为「模型调用 / API 密钥」,说明文字为「管理我的API密钥,可调用大模型服务,支持查看额度、复制密钥并设置到期时间。」。
工具栏从左到右依次为:搜索维度下拉「选择搜索维度」、「额度」筛选、「状态」筛选;右侧为蓝色「创建」按钮、「列显隐」和「刷新」。
表格字段如下:
| 字段 | 说明 |
|---|---|
| 名称 | 密钥名称,下方灰字显示归属与密钥尾号,例如「admin/eb826dbe」,尾号后的图标可复制。 |
| 状态 | 密钥当前状态,截图中出现「已启用」「已禁用」「管理员已禁用」。 |
| API Key | 脱敏后的密钥值,例如「sk-******eb826dbe」,行内图标可复制。 |
| 额度 | 额度类型,截图中为「不限」或「暂不可用」。 |
| 剩余/总额 | 剩余额度与总额度,截图中为「不限」或「额度暂不可用」。 |
| 描述 | 密钥的用途说明。 |
| 创建时间 | 密钥创建时间。 |
| 到期时间 | 密钥到期时间。 |
| 额度更新时间 | 最近一次额度调整时间。 |
| 操作 | 「额度明细」和「更多操作」。 |
截图中当前视图显示「名称」「状态」「API Key」「额度」「剩余/总额」「操作」,其余列可通过「列显隐」打开。列表底部显示总数,截图中为「共 1039 条」,右侧为每页条数与翻页控件。
单击「创建」后,页面右侧滑出「创建 API 密钥」抽屉,标题下的说明为「密钥归属当前登录用户所有。」。抽屉中只有两个字段:
| 字段 | 说明 |
|---|---|
| API 密钥名称* | 密钥名称,带星号表示必填。 |
| 描述 | 密钥用途说明,多行文本。 |
抽屉底部为「取消」和蓝色的「创建」按钮。
操作步骤
创建密钥
- 在左侧导航选择「模型调用」>「API 密钥」。
- 单击工具栏右侧的「创建」。
- 在「创建 API 密钥」抽屉中填写「API 密钥名称*」和「描述」。
- 单击抽屉底部的「创建」。
复制密钥
- 在目标行找到「API Key」列。
- 单击脱敏值后的复制图标,将密钥复制到剪贴板。
- 需要复制密钥名称或归属信息时,单击「名称」列灰字后的复制图标。
查看额度
- 在目标行单击「额度明细」,查看该密钥的额度记录。
- 需要其他维护操作时,单击该行的「更多操作」。
- 用工具栏的「额度」「状态」筛选缩小列表范围。
调用模型
调用地址和模型名称以「模型列表」中模型详情页提供的信息为准。下面是最小示例,替换尖括号中的内容后使用。
bash
curl "<模型调用地址>" \
-H "Authorization: Bearer <API Key>" \
-H "Content-Type: application/json" \
-d '{
"model": "<模型名称>",
"messages": [{"role": "user", "content": "你好"}]
}'使用 OpenAI SDK 时,把 base_url 指向模型详情页提供的地址,api_key 填完整密钥。
python
from openai import OpenAI
client = OpenAI(
base_url="<模型调用地址>",
api_key="<API Key>",
)
resp = client.chat.completions.create(
model="<模型名称>",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)结果验证
- 创建后列表中出现新记录,名称与抽屉中填写的内容一致。
- 复制后粘贴到调用脚本中,密钥前缀为「sk-」。
- 单击「额度明细」后能看到该密钥的额度变化记录。
- 状态筛选为「已禁用」时,列表只剩被禁用的密钥。
注意事项
- 密钥归属当前登录用户,其他成员看不到、也不能使用你的密钥。
- 状态为「已禁用」或「管理员已禁用」的密钥不能用于调用;后者需要管理员处理。
- 「额度」显示「暂不可用」时,「剩余/总额」列同步显示「额度暂不可用」,此时无法判断剩余量。
- 密钥等同于账号凭证,不要写入公开代码仓库、前端代码或截图。
- 「更多操作」中的删除类操作不可恢复,执行前确认没有业务仍在使用该密钥。